home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / less.man < prev    next >
Text File  |  1992-01-02  |  41KB  |  1,123 lines

  1.  
  2.  
  3.  
  4. LESS                      User Commands                      LESS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      less - opposite of more
  10.  
  11. SSYYNNOOPPSSIISS
  12.      lleessss --??
  13.      lleessss [[--[[++]]aaBBccCCddeeEEffHHiimmMMnnNNqqQQrrssSSuuUUww]]
  14.           [[--bb _b_u_f_s]] [[--hh _l_i_n_e_s]] [[--jj _l_i_n_e]] [[--kk _k_e_y_f_i_l_e]]
  15.           [[--{{ooOO}} _l_o_g_f_i_l_e]] [[--pp _p_a_t_t_e_r_n]] [[--PP _p_r_o_m_p_t]] [[--tt _t_a_g]]
  16.           [[--TT _t_a_g_f_i_l_e]] [[--xx _t_a_b]] [[--yy _l_i_n_e_s]] [[--[[zz]] _l_i_n_e_s]]
  17.           [[++[[++]]_c_m_d]] [[_f_i_l_e_n_a_m_e]]......
  18.  
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      _L_e_s_s is a program similar to _m_o_r_e (1), but which allows
  22.      backward movement in the file as well as forward movement.
  23.      Also, _l_e_s_s does not have to read the entire input file
  24.      before starting, so with large input files it starts up fas-
  25.      ter than text editors like _v_i (1).  _L_e_s_s uses termcap (or
  26.      terminfo on some systems), so it can run on a variety of
  27.      terminals.  There is even limited support for hardcopy ter-
  28.      minals.  (On a hardcopy terminal, lines which should be
  29.      printed at the top of the screen are prefixed with an up-
  30.      arrow.)
  31.  
  32.      Commands are based on both _m_o_r_e and _v_i. Commands may be pre-
  33.      ceded by a decimal number, called N in the descriptions
  34.      below.  The number is used by some commands, as indicated.
  35.  
  36.  
  37. CCOOMMMMAANNDDSS
  38.      In the following descriptions, ^X means control-X.  ESC
  39.      stands for the ESCAPE key; for example ESC-v means the two
  40.      character sequence "ESCAPE", then "v".
  41.  
  42.      h or H
  43.           Help: display a summary of these commands.  If you for-
  44.           get all the other commands, remember this one.
  45.  
  46.      SPACE or ^V or f or ^F
  47.           Scroll forward N lines, default one window (see option
  48.           -z below).  If N is more than the screen size, only the
  49.           final screenful is displayed.  Warning: some systems
  50.           use ^V as a special literalization character.
  51.  
  52.      z    Like SPACE, but if N is specified, it becomes the new
  53.           window size.
  54.  
  55.      RETURN or ^N or e or ^E or j or ^J
  56.           Scroll forward N lines, default 1.  The entire N lines
  57.           are displayed, even if N is more than the screen size.
  58.  
  59.      d or ^D
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LESS                      User Commands                      LESS
  71.  
  72.  
  73.  
  74.           Scroll forward N lines, default one half of the screen
  75.           size.  If N is specified, it becomes the new default
  76.           for subsequent d and u commands.
  77.  
  78.      b or ^B or ESC-v
  79.           Scroll backward N lines, default one window (see option
  80.           -z below).  If N is more than the screen size, only the
  81.           final screenful is displayed.
  82.  
  83.      w    Like ESC-v, but if N is specified, it becomes the new
  84.           window size.
  85.  
  86.      y or ^Y or ^P or k or ^K
  87.           Scroll backward N lines, default 1.  The entire N lines
  88.           are displayed, even if N is more than the screen size.
  89.           Warning: some systems use ^Y as a special job control
  90.           character.
  91.  
  92.      u or ^U
  93.           Scroll backward N lines, default one half of the screen
  94.           size.  If N is specified, it becomes the new default
  95.           for subsequent d and u commands.
  96.  
  97.      r or ^R or ^L
  98.           Repaint the screen.
  99.  
  100.      R    Repaint the screen, discarding any buffered input.
  101.           Useful if the file is changing while it is being
  102.           viewed.
  103.  
  104.      F    Scroll forward, and keep trying to read when the end of
  105.           file is reached.  Normally this command would be used
  106.           when already at the end of the file.  It is a way to
  107.           monitor the tail of a file which is growing while it is
  108.           being viewed.  (The behavior is similar to the "tail
  109.           -f" command.)
  110.  
  111.      g or < or ESC-<
  112.           Go to line N in the file, default 1 (beginning of
  113.           file).  (Warning: this may be slow if N is large.)
  114.  
  115.      G or > or ESC->
  116.           Go to line N in the file, default the end of the file.
  117.           (Warning: this may be slow if N is large, or if N is
  118.           not specified and standard input, rather than a file,
  119.           is being read.)
  120.  
  121.      p or %
  122.           Go to a position N percent into the file.  N should be
  123.           between 0 and 100.  (This works if standard input is
  124.           being read, but only if _l_e_s_s has already read to the
  125.           end of the file.  It is always fast, but not always
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LESS                      User Commands                      LESS
  137.  
  138.  
  139.  
  140.           useful.)
  141.  
  142.      {    If a left curly bracket appears in the top line
  143.           displayed on the screen, the { command will go to the
  144.           matching right curly bracket.  The matching right curly
  145.           bracket is positioned on the bottom line of the screen.
  146.           If there is more than one left curly bracket on the top
  147.           line, a number N may be used to specify the N-th
  148.           bracket on the line.
  149.  
  150.      }    If a right curly bracket appears in the bottom line
  151.           displayed on the screen, the } command will go to the
  152.           matching left curly bracket.  The matching left curly
  153.           bracket is positioned on the top line of the screen.
  154.           If there is more than one right curly bracket on the
  155.           top line, a number N may be used to specify the N-th
  156.           bracket on the line.
  157.  
  158.      (    Like {, but applies to parentheses rather than curly
  159.           brackets.
  160.  
  161.      )    Like }, but applies to parentheses rather than curly
  162.           brackets.
  163.  
  164.      [    Like {, but applies to square brackets rather than
  165.           curly brackets.
  166.  
  167.      ]    Like }, but applies to square brackets rather than
  168.           curly brackets.
  169.  
  170.      ESC-^F
  171.           Followed by two characters, acts like {, but uses the
  172.           two characters as open and close brackets, respec-
  173.           tively.  For example, "ESC ^F < >" could be used to go
  174.           forward to the > which matches the < in the top
  175.           displayed line.
  176.  
  177.      ESC-^B
  178.           Followed by two characters, acts like }, but uses the
  179.           two characters as open and close brackets, respec-
  180.           tively.  For example, "ESC ^B < >" could be used to go
  181.           backward to the < which matches the > in the bottom
  182.           displayed line.
  183.  
  184.      m    Followed by any lowercase letter, marks the current
  185.           position with that letter.
  186.  
  187.      '    (Single quote.) Followed by any lowercase letter,
  188.           returns to the position which was previously marked
  189.           with that letter.  Followed by another single quote,
  190.           returns to the position at which the last "large" move-
  191.           ment command was executed.  Followed by a ^ or $, jumps
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LESS                      User Commands                      LESS
  203.  
  204.  
  205.  
  206.           to the beginning or end of the file respectively.
  207.           Marks are preserved when a new file is examined, so the
  208.           ' command can be used to switch between input files.
  209.  
  210.      ^X^X Same as single quote.
  211.  
  212.      /pattern
  213.           Search forward in the file for the N-th line containing
  214.           the pattern.  N defaults to 1.  The pattern is a regu-
  215.           lar expression, as recognized by _e_d. The search starts
  216.           at the second line displayed (but see the -a and -j
  217.           options, which change this).
  218.  
  219.           Certain characters are special if entered at the begin-
  220.           ning of the pattern; they modify the type of search
  221.           rather than become part of the pattern:
  222.  
  223.           !    Search for lines which do NOT match the pattern.
  224.  
  225.           *    Search multiple files.  That is, if the search
  226.                reaches the end of the current file without find-
  227.                ing a match, the search continues in the next file
  228.                in the command line list.
  229.  
  230.           @    Begin the search at the first line of the first
  231.                file in the command line list, regardless of what
  232.                is currently displayed on the screen or the set-
  233.                tings of the -a or -j options.
  234.  
  235.      ?pattern
  236.           Search backward in the file for the N-th line contain-
  237.           ing the pattern.  The search starts at the line immedi-
  238.           ately before the top line displayed.
  239.  
  240.           Certain characters are special as in the / command:
  241.  
  242.           !    Search for lines which do NOT match the pattern.
  243.  
  244.           *    Search multiple files.  That is, if the search
  245.                reaches the beginning of the current file without
  246.                finding a match, the search continues in the pre-
  247.                vious file in the command line list.
  248.  
  249.           @    Begin the search at the last line of the last file
  250.                in the command line list, regardless of what is
  251.                currently displayed on the screen or the settings
  252.                of the -a or -j options.
  253.  
  254.      ESC-/pattern
  255.           Same as "/*".
  256.  
  257.      ESC-?pattern
  258.  
  259.  
  260.  
  261. Sprite v1.0                                                     4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. LESS                      User Commands                      LESS
  269.  
  270.  
  271.  
  272.           Same as "?*".
  273.  
  274.      n    Repeat previous search, for N-th line containing the
  275.           last pattern.  If the previous search was modified by
  276.           !, the search is made for the N-th line NOT containing
  277.           the pattern.  If the previous search was modified by *,
  278.           the search continues in the next (or previous) file if
  279.           not satisfied in the current file.  There is no effect
  280.           if the previous search was modified by @.
  281.  
  282.      N    Repeat previous search, but in the reverse direction.
  283.  
  284.      ESC-n
  285.           Repeat previous search, but crossing file boundaries.
  286.           The effect is as if the previous search were modified
  287.           by *.
  288.  
  289.      ESC-N
  290.           Repeat previous search, but in the reverse direction
  291.           and crossing file boundaries.
  292.  
  293.      :e [filename]
  294.           Examine a new file.  If the filename is missing, the
  295.           "current" file (see the :n and :p commands below) from
  296.           the list of files in the command line is re-examined.
  297.           A percent sign (%) in the filename is replaced by the
  298.           name of the current file. A pound sign (#) is replaced
  299.           by the name of the previously examined file.  The
  300.           filename is inserted into the command line list of
  301.           files so that it can be seen by subsequent :n and :p
  302.           commands.  If the filename consists of several files,
  303.           they are all inserted into the list of files and the
  304.           first one is examined.
  305.  
  306.      ^X^V or E
  307.           Same as :e.  Warning: some systems use ^V as a special
  308.           literalization character.
  309.  
  310.      :n   Examine the next file (from the list of files given in
  311.           the command line).  If a number N is specified, the N-
  312.           th next file is examined.
  313.  
  314.      :p   Examine the previous file in the command line list.  If
  315.           a number N is specified, the N-th previous file is
  316.           examined.
  317.  
  318.      :x   Examine the first file in the command line list.  If a
  319.           number N is specified, the N-th file in the list is
  320.           examined.
  321.  
  322.      = or ^G or :f
  323.           Prints some information about the file being viewed,
  324.  
  325.  
  326.  
  327. Sprite v1.0                                                     5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. LESS                      User Commands                      LESS
  335.  
  336.  
  337.  
  338.           including its name and the line number and byte offset
  339.           of the bottom line being displayed.  If possible, it
  340.           also prints the length of the file, the number of lines
  341.           in the file and the percent of the file above the last
  342.           displayed line.
  343.  
  344.      -    Followed by one of the command line option letters (see
  345.           below), this will change the setting of that option and
  346.           print a message describing the new setting.  If the
  347.           option letter has a numeric value (such as -b or -h),
  348.           or a string value (such as -P or -t), a new value may
  349.           be entered after the option letter.  If no new value is
  350.           entered, a message describing the current setting is
  351.           printed and nothing is changed.
  352.  
  353.      -+   Followed by one of the command line option letters (see
  354.           below), this will reset the option to its default set-
  355.           ting and print a message describing the new setting.
  356.           (The "-+_X" command does the same thing as "-+_X" on the
  357.           command line.) This does not work for string-valued
  358.           options.
  359.  
  360.      --   Followed by one of the command line option letters (see
  361.           below), this will reset the option to the "opposite" of
  362.           its default setting and print a message describing the
  363.           new setting.  (The "--_X" command does the same thing as
  364.           "-_X" on the command line.) This does not work for
  365.           numeric or string-valued options.
  366.  
  367.      _    (Underscore.) Followed by one of the command line
  368.           option letters (see below), this will print a message
  369.           describing the current setting of that option.  The
  370.           setting of the option is not changed.
  371.  
  372.      +cmd Causes the specified cmd to be executed each time a new
  373.           file is examined.  For example, +G causes _l_e_s_s to ini-
  374.           tially display each file starting at the end rather
  375.           than the beginning.
  376.  
  377.      V    Prints the version number of _l_e_s_s being run.
  378.  
  379.      q or :q or :Q or ZZ or ESC ESC
  380.           Exits _l_e_s_s.
  381.  
  382.      The following three commands may or may not be valid,
  383.      depending on your particular installation.
  384.  
  385.      v    Invokes an editor to edit the current file being
  386.           viewed.  The editor is taken from the environment vari-
  387.           able EDITOR, or defaults to "vi".  See also the discus-
  388.           sion of LESSEDIT under the section on PROMPTS below.
  389.  
  390.  
  391.  
  392.  
  393. Sprite v1.0                                                     6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. LESS                      User Commands                      LESS
  401.  
  402.  
  403.  
  404.      ! shell-command
  405.           Invokes a shell to run the shell-command given.  A per-
  406.           cent sign (%) in the command is replaced by the name of
  407.           the current file. A pound sign (#) is replaced by the
  408.           name of the previously examined file.  "!!" repeats the
  409.           last shell command.  "!" with no shell command simply
  410.           invokes a shell.  In all cases, the shell is taken from
  411.           the environment variable SHELL, or defaults to "sh".
  412.  
  413.      | <m> shell-command
  414.           <m> represents any mark letter.  Pipes a section of the
  415.           input file to the given shell command.  The section of
  416.           the file to be piped is between the first line on the
  417.           current screen and the position marked by the letter.
  418.           <m> may also be ^ or $ to indicate beginning or end of
  419.           file respectively.  If <m> is . or newline, the current
  420.           screen is piped.
  421.  
  422. OOPPTTIIOONNSS
  423.      Command line options are described below.  Most options may
  424.      be changed while _l_e_s_s is running, via the "-" command.
  425.  
  426.      Options are also taken from the environment variable "LESS".
  427.      For example, to avoid typing "less -options ..." each time
  428.      _l_e_s_s is invoked, you might tell _c_s_h:
  429.  
  430.      setenv LESS "-options"
  431.  
  432.      or if you use _s_h:
  433.  
  434.      LESS="-options"; export LESS
  435.  
  436.      The environment variable is parsed before the command line,
  437.      so command line options override the LESS environment vari-
  438.      able.  If an option appears in the LESS variable, it can be
  439.      reset to its default on the command line by beginning the
  440.      command line option with "-+".
  441.  
  442.      A dollar sign ($) may be used to signal the end of an option
  443.      string.  This is important only for options like -P which
  444.      take a following string.
  445.  
  446.      -?   This option displays a summary of the commands accepted
  447.           by _l_e_s_s (the same as the h command).  If this option is
  448.           given, all other options are ignored, and _l_e_s_s exits
  449.           after the help screen is viewed.  (Depending on how
  450.           your shell interprets the question mark, it may be
  451.           necessary to quote the question mark, thus: "-\?".)
  452.  
  453.      -a   Causes searches to start after the last line displayed
  454.           on the screen, thus skipping all lines displayed on the
  455.           screen.  By default, searches start at the second line
  456.  
  457.  
  458.  
  459. Sprite v1.0                                                     7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. LESS                      User Commands                      LESS
  467.  
  468.  
  469.  
  470.           on the screen (or after the last found line; see the -j
  471.           option).
  472.  
  473.      -b_n  Causes _l_e_s_s to use a non-standard number of buffers.
  474.           Buffers are 1K, and by default 10 buffers are used
  475.           (except if data in coming from standard input; see the
  476.           -B option).  The number _n specifies a different number
  477.           of buffers to use.
  478.  
  479.      -B   Disables automatic allocation of buffers, so that only
  480.           the default number of buffers are used.  If more data
  481.           is read than will fit in the buffers, the oldest data
  482.           is discarded.  By default, when data is coming from
  483.           standard input, buffers are allocated automatically as
  484.           needed to avoid loss of data.
  485.  
  486.      -c   Causes full screen repaints to be painted from the top
  487.           line down.  By default, full screen repaints are done
  488.           by scrolling from the bottom of the screen.
  489.  
  490.      -C   The -C option is like -c, but the screen is cleared
  491.           before it is repainted.
  492.  
  493.      -d   The -d option suppresses the error message normally
  494.           displayed if the terminal is dumb; that is, lacks some
  495.           important capability, such as the ability to clear the
  496.           screen or scroll backward.  The -d option does not oth-
  497.           erwise change the behavior of _l_e_s_s on a dumb terminal).
  498.  
  499.      -e   Causes _l_e_s_s to automatically exit the second time it
  500.           reaches end-of-file.  By default, the only way to exit
  501.           _l_e_s_s is via the "q" command.
  502.  
  503.      -E   Causes _l_e_s_s to automatically exit the first time it
  504.           reaches end-of-file.
  505.  
  506.      -f   Forces non-regular files to be opened.  (A non-regular
  507.           file is a directory or a device special file.) Also
  508.           suppresses the warning message when a binary file is
  509.           opened.  By default, _l_e_s_s will refuse to open non-
  510.           regular files.
  511.  
  512.      -h_n  Specifies a maximum number of lines to scroll backward.
  513.           If it is necessary to scroll backward more than _n
  514.           lines, the screen is repainted in a forward direction
  515.           instead.  (If the terminal does not have the ability to
  516.           scroll backward, -h0 is implied.)
  517.  
  518.      -i   Causes searches to ignore case; that is, uppercase and
  519.           lowercase are considered identical.  Also, text which
  520.           is overstruck or underlined can be searched for.  This
  521.           option is ignored if any uppercase letters appear in
  522.  
  523.  
  524.  
  525. Sprite v1.0                                                     8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. LESS                      User Commands                      LESS
  533.  
  534.  
  535.  
  536.           the search pattern.
  537.  
  538.      -j_n  Specifies a line on the screen where "target" lines are
  539.           to be positioned.  Target lines are the object of text
  540.           searches, tag searches, jumps to a line number, jumps
  541.           to a file percentage, and jumps to a marked position.
  542.           The screen line is specified by a number: the top line
  543.           on the screen is 1, the next is 2, and so on.  The
  544.           number may be negative to specify a line relative to
  545.           the bottom of the screen: the bottom line on the screen
  546.           is -1, the second to the bottom is -2, and so on.  If
  547.           the -j option is used, searches begin at the line
  548.           immediately after the target line.  For example, if "-
  549.           j4" is used, the target line is the fourth line on the
  550.           screen, so searches begin at the fifth line on the
  551.           screen.
  552.  
  553.      -k_f_i_l_e_n_a_m_e
  554.           Causes _l_e_s_s to open and interpret the named file as a
  555.           _l_e_s_s_k_e_y (1) file.  Multiple -k options may be speci-
  556.           fied.  If a file called .less exists in the user's home
  557.           directory, this file is also used as a _l_e_s_s_k_e_y file.
  558.  
  559.      -m   Causes _l_e_s_s to prompt verbosely (like _m_o_r_e), with the
  560.           percent into the file.  By default, _l_e_s_s prompts with a
  561.           colon.
  562.  
  563.      -M   Causes _l_e_s_s to prompt even more verbosely than _m_o_r_e.
  564.  
  565.      -n   Suppresses line numbers.  The default (to use line
  566.           numbers) may cause _l_e_s_s to run more slowly in some
  567.           cases, especially with a very large input file.
  568.           Suppressing line numbers with the -n flag will avoid
  569.           this problem.  Using line numbers means: the line
  570.           number will be displayed in the verbose prompt and in
  571.           the = command, and the v command will pass the current
  572.           line number to the editor (see also the discussion of
  573.           LESSEDIT in PROMPTS below).
  574.  
  575.      -N   Causes a line number to be displayed at the beginning
  576.           of each line in the display.
  577.  
  578.      -o_f_i_l_e_n_a_m_e
  579.           Causes _l_e_s_s to copy its input to the named file as it
  580.           is being viewed.  This applies only when the input file
  581.           is a pipe, not an ordinary file.  If the file already
  582.           exists, _l_e_s_s will ask for confirmation before overwrit-
  583.           ing it.
  584.  
  585.      -O_f_i_l_e_n_a_m_e
  586.           The -O option is like -o, but it will overwrite an
  587.           existing file without asking for confirmation.
  588.  
  589.  
  590.  
  591. Sprite v1.0                                                     9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. LESS                      User Commands                      LESS
  599.  
  600.  
  601.  
  602.           If no log file has been specified, the -o and -O
  603.           options can be used from within _l_e_s_s to specify a log
  604.           file.  Without a file name, they will simply report the
  605.           name of the log file.  The "s" command is equivalent to
  606.           specifying -o from within _l_e_s_s.
  607.  
  608.      -p_p_a_t_t_e_r_n
  609.           The -p option on the command line is equivalent to
  610.           specifying +/_p_a_t_t_e_r_n; that is, it tells _l_e_s_s to start
  611.           at the first occurence of _p_a_t_t_e_r_n in the file.
  612.  
  613.      -P_p_r_o_m_p_t
  614.           Provides a way to tailor the three prompt styles to
  615.           your own preference.  This option would normally be put
  616.           in the LESS environment variable, rather than being
  617.           typed in with each _l_e_s_s command.  Such an option must
  618.           either be the last option in the LESS variable, or be
  619.           terminated by a dollar sign.  -P followed by a string
  620.           changes the default (short) prompt to that string.  -Pm
  621.           changes the medium (-m) prompt to the string, and -PM
  622.           changes the long (-M) prompt.  Also, -P= changes the
  623.           message printed by the = command to the given string.
  624.           All prompt strings consist of a sequence of letters and
  625.           special escape sequences.  See the section on PROMPTS
  626.           for more details.
  627.  
  628.      -q   Causes moderately "quiet" operation: the terminal bell
  629.           is not rung if an attempt is made to scroll past the
  630.           end of the file or before the beginning of the file.
  631.           If the terminal has a "visual bell", it is used
  632.           instead.  The bell will be rung on certain other
  633.           errors, such as typing an invalid character.  The
  634.           default is to ring the terminal bell in all such cases.
  635.  
  636.      -Q   Causes totally "quiet" operation: the terminal bell is
  637.           never rung.
  638.  
  639.      -r   Causes "raw" control characters to be displayed.  The
  640.           default is to display control characters using the
  641.           caret notation; for example, a control-A (octal 001) is
  642.           displayed as "^A".  Warning: when the -r flag is used,
  643.           _l_e_s_s cannot keep track of the actual appearance of the
  644.           screen (since this depends on how the screen responds
  645.           to each type of control character).  Thus, various
  646.           display problems may result, such as long lines being
  647.           split in the wrong place.
  648.  
  649.      -s   Causes consecutive blank lines to be squeezed into a
  650.           single blank line.  This is useful when viewing _n_r_o_f_f
  651.           output.
  652.  
  653.      -S   Causes lines longer than the screen width to be chopped
  654.  
  655.  
  656.  
  657. Sprite v1.0                                                    10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. LESS                      User Commands                      LESS
  665.  
  666.  
  667.  
  668.           rather than folded.  That is, the remainder of a long
  669.           line is simply discarded.  The default is to fold long
  670.           lines; that is, display the remainder on the next line.
  671.  
  672.      -t_t_a_g
  673.           The -t option, followed immediately by a TAG, will edit
  674.           the file containing that tag.  For this to work, there
  675.           must be a file called "tags" in the current directory,
  676.           which was previously built by the _c_t_a_g_s (1) command.
  677.           This option may also be specified from within _l_e_s_s
  678.           (using the - command) as a way of examining a new file.
  679.           The command ":t" is equivalent to specifying -t from
  680.           within _l_e_s_s.
  681.  
  682.      -T_t_a_g_s_f_i_l_e
  683.           Specifies a tags file to be used instead of "tags".
  684.  
  685.      -u   Causes backspaces and carriage returns to be treated as
  686.           printable characters; that is, they are sent to the
  687.           terminal when they appear in the input.
  688.  
  689.      -U   Causes backspaces and carriage returns to be treated as
  690.           control characters; that is, they are handled as speci-
  691.           fied by the -r option.
  692.  
  693.           By default, if neither -u nor -U is given, backspaces
  694.           which appear adjacent to an underscore character are
  695.           treated specially: the underlined text is displayed
  696.           using the terminal's hardware underlining capability.
  697.           Also, backspaces which appear between two identical
  698.           characters are treated specially: the overstruck text
  699.           is printed using the terminal's hardware boldface capa-
  700.           bility.  Other backspaces are deleted, along with the
  701.           preceding character.  Carriage returns immediately fol-
  702.           lowed by a newline are deleted.  Other carriage returns
  703.           are handled as specified by the -r option.
  704.  
  705.      -w   Causes blank lines to be used to represent lines past
  706.           the end of the file.  By default, a tilde character is
  707.           used.
  708.  
  709.      -x_n  Sets tab stops every _n positions.  The default for _n is
  710.           8.
  711.  
  712.      -y_n  Specifies a maximum number of lines to scroll forward.
  713.           If it is necessary to scroll forward more than _n lines,
  714.           the screen is repainted instead.  The -c or -C option
  715.           may be used to repaint from the top of the screen if
  716.           desired.  By default, any forward movement causes
  717.           scrolling.
  718.  
  719.      -[z]_n
  720.  
  721.  
  722.  
  723. Sprite v1.0                                                    11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. LESS                      User Commands                      LESS
  731.  
  732.  
  733.  
  734.           Changes the default scrolling window size to _n lines.
  735.           The default is one screenful.  The z and w commands can
  736.           also be used to change the window size.  The "z" may be
  737.           omitted, as in "-_n" for compatibility with _m_o_r_e.
  738.  
  739.      +    If a command line option begins with ++, the remainder
  740.           of that option is taken to be an initial command to
  741.           _l_e_s_s. For example, +G tells _l_e_s_s to start at the end of
  742.           the file rather than the beginning, and +/xyz tells it
  743.           to start at the first occurrence of "xyz" in the file.
  744.           As a special case, +<number> acts like +<number>g; that
  745.           is, it starts the display at the specified line number
  746.           (however, see the caveat under the "g" command above).
  747.           If the option starts with ++, the initial command
  748.           applies to every file being viewed, not just the first
  749.           one.  The + command described previously may also be
  750.           used to set (or change) an initial command for every
  751.           file.
  752.  
  753.  
  754. KKEEYY BBIINNDDIINNGGSS
  755.      You may define your own _l_e_s_s commands by using the program
  756.      _l_e_s_s_k_e_y (1) to create a file called ".less" in your home
  757.      directory.  This file specifies a set of command keys and an
  758.      action associated with each key.  See the _l_e_s_s_k_e_y manual
  759.      page for more details.
  760.  
  761.  
  762. NNAATTIIOONNAALL CCHHAARRAACCTTEERR SSEETTSS
  763.      There are three types of characters in the input file:
  764.  
  765.      normal characters
  766.           can be displayed directly to the screen.
  767.  
  768.      control characters
  769.           should not be displayed directly, but are expected to
  770.           be found in ordinary text files (such as backspace and
  771.           tab).
  772.  
  773.      binary characters
  774.           cannot be displayed directly and are not expected to be
  775.           found in text files.
  776.  
  777.      By default, _l_e_s_s uses the ASCII character set.  In the ASCII
  778.      character set, characters with values between 128 and 255
  779.      are treated as binary.  The LESSCHARSET environment variable
  780.      may be used to select another character set.  If it is set
  781.      to the value "latin1", the ISO 8859/1 character set is
  782.      assumed.  Latin-1 is the same as ASCII, except characters
  783.      between 128 and 255 are treated as normal characters.  The
  784.      only valid values for LESSCHARSET currently are "ascii" and
  785.      "latin1".
  786.  
  787.  
  788.  
  789. Sprite v1.0                                                    12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. LESS                      User Commands                      LESS
  797.  
  798.  
  799.  
  800.      In special cases, it may be desired to tailor _l_e_s_s to use a
  801.      character set other than the ones definable by LESSCHARSET.
  802.      In this case, the environment variable LESSCHARDEF can be
  803.      used to define a character set.  It should be set to a
  804.      string where each character in the string represents one
  805.      character in the character set.  The character "." is used
  806.      for a normal character, "c" for control, and "b" for binary.
  807.      A decimal number may be used for repetition.  For example,
  808.      "bccc4b." would mean character 0 is binary, 1, 2 and 3 are
  809.      control, 4, 5, 6 and 7 are binary, and 8 is normal.  All
  810.      characters after the last are taken to be the same as the
  811.      last, so characters 9 through 255 would be normal.  (This is
  812.      an example, and does not necessarily represent any real
  813.      character set.)
  814.  
  815.      Setting LESSCHARDEF to "8bcccbcc18b95.b" is the same as set-
  816.      ting LESSCHARSET to "ascii".  Setting LESSCHARDEF to
  817.      "8bcccbcc18b95.33b." is the same as setting LESSCHARSET to
  818.      "latin1".
  819.  
  820.      Control and binary characters are displayed in blinking
  821.      mode.  Each such character is displayed in caret notation if
  822.      possible (e.g. ^A for control-A).  Caret notation is used
  823.      only if inverting the 0100 bit results in a normal printable
  824.      character.  Otherwise, the character is displayed as an
  825.      octal number preceded by a backslash.  This octal format can
  826.      be changed by setting the LESSBINFMT environment variable to
  827.      a printf-style format string; the default is '\%o'.  The
  828.      blinking mode display of control and binary characters can
  829.      be changed or disabled by preceding the LESSBINFMT format
  830.      string with a "*" and one character to select the mode: "*k"
  831.      is blinking, "*d" is bold, "*u" is underlined, and "*n" is
  832.      normal (no special display attribute).  For example, if
  833.      LESSBINFMT is "*u[%x]", binary characters are displayed in
  834.      underlined hexadecimal surrounded by brackets.
  835.  
  836.  
  837. PPRROOMMPPTTSS
  838.      The -P option allows you to tailor the prompt to your
  839.      preference.  The string given to the -P option replaces the
  840.      specified prompt string.  Certain characters in the string
  841.      are interpreted specially.  The prompt mechanism is rather
  842.      complicated to provide flexibility, but the ordinary user
  843.      need not understand the details of constructing personalized
  844.      prompt strings.
  845.  
  846.      A percent sign followed by a single character is expanded
  847.      according to what the following character is:
  848.  
  849.      %b_X  Replaced by the byte offset into the current input
  850.           file.  The b is followed by a single character (shown
  851.           as _X above) which specifies the line whose byte offset
  852.  
  853.  
  854.  
  855. Sprite v1.0                                                    13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. LESS                      User Commands                      LESS
  863.  
  864.  
  865.  
  866.           is to be used.  If the character is a "t", the byte
  867.           offset of the top line in the display is used, an "m"
  868.           means use the middle line, a "b" means use the bottom
  869.           line, a "B" means use the line just after the bottom
  870.           line, and a "j" means use the "target" line, as speci-
  871.           fied by the -j option.
  872.  
  873.      %B   Replaced by the size of the current input file.
  874.  
  875.      %E   Replaced by the name of the editor (from the EDITOR
  876.           environment variable).  See the discussion of the
  877.           LESSEDIT feature below.
  878.  
  879.      %f   Replaced by the name of the current input file.
  880.  
  881.      %i   Replaced by the index of the current file in the list
  882.           of input files.
  883.  
  884.      %l_X  Replaced by the line number of a line in the input
  885.           file.  The line to be used is determined by the _X, as
  886.           with the %b option.
  887.  
  888.      %L   Replaced by the line number of the last line in the
  889.           input file.
  890.  
  891.      %m   Replaced by the total number of input files.
  892.  
  893.      %p_X  Replaced by the percent into the current input file.
  894.           The line used is determined by the _X as with the %b
  895.           option.
  896.  
  897.      %s   Same as %B.
  898.  
  899.      %t   Causes any trailing spaces to be removed.  Usually used
  900.           at the end of the string, but may appear anywhere.
  901.  
  902.      %x   Replaced by the name of the next input file in the
  903.           list.
  904.  
  905.      If any item is unknown (for example, the file size if input
  906.      is a pipe), a question mark is printed instead.
  907.  
  908.      The format of the prompt string can be changed depending on
  909.      certain conditions.  A question mark followed by a single
  910.      character acts like an "IF": depending on the following
  911.      character, a condition is evaluated.  If the condition is
  912.      true, any characters following the question mark and condi-
  913.      tion character, up to a period, are included in the prompt.
  914.      If the condition is false, such characters are not included.
  915.      A colon appearing between the question mark and the period
  916.      can be used to establish an "ELSE": any characters between
  917.      the colon and the period are included in the string if and
  918.  
  919.  
  920.  
  921. Sprite v1.0                                                    14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. LESS                      User Commands                      LESS
  929.  
  930.  
  931.  
  932.      only if the IF condition is false.  Condition characters
  933.      (which follow a question mark) may be:
  934.  
  935.      ?a   True if any characters have been included in the prompt
  936.           so far.
  937.  
  938.      ?b_X  True if the byte offset of the specified line is known.
  939.  
  940.      ?B   True if the size of current input file is known.
  941.  
  942.      ?e   True if at end-of-file.
  943.  
  944.      ?f   True if there is an input filename (that is, if input
  945.           is not a pipe).
  946.  
  947.      ?l_X  True if the line number of the specified line is known.
  948.  
  949.      ?L   True if the line number of the last line in the file is
  950.           known.
  951.  
  952.      ?m   True if there is more than one input file.
  953.  
  954.      ?n   True if this is the first prompt in a new input file.
  955.  
  956.      ?p_X  True if the percent into the current input file of the
  957.           specified line is known.
  958.  
  959.      ?s   Same as "?B".
  960.  
  961.      ?x   True if there is a next input file (that is, if the
  962.           current input file is not the last one).
  963.  
  964.      Any characters other than the special ones (question mark,
  965.      colon, period, percent, and backslash) become literally part
  966.      of the prompt.  Any of the special characters may be
  967.      included in the prompt literally by preceding it with a
  968.      backslash.
  969.  
  970.      Some examples:
  971.  
  972.      ?f%f:Standard input.
  973.  
  974.      This prompt prints the filename, if known; otherwise the
  975.      string "Standard input".
  976.  
  977.      ?f%f .?ltLine %lt:?pt%pt\%:?btByte %bt:-...
  978.  
  979.      This prompt would print the filename, if known.  The
  980.      filename is followed by the line number, if known, otherwise
  981.      the percent if known, otherwise the byte offset if known.
  982.      Otherwise, a dash is printed.  Notice how each question mark
  983.      has a matching period, and how the % after the %pt is
  984.  
  985.  
  986.  
  987. Sprite v1.0                                                    15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. LESS                      User Commands                      LESS
  995.  
  996.  
  997.  
  998.      included literally by escaping it with a backslash.
  999.  
  1000.      ?n?f%f .?m(file %i of %m) ..?e(END) ?x- Next\: %x..%t
  1001.  
  1002.      This prints the filename if this is the first prompt in a
  1003.      file, followed by the "file N of N" message if there is more
  1004.      than one input file.  Then, if we are at end-of-file, the
  1005.      string "(END)" is printed followed by the name of the next
  1006.      file, if there is one.  Finally, any trailing spaces are
  1007.      truncated.  This is the default prompt.  For reference, here
  1008.      are the defaults for the other two prompts (-m and -M
  1009.      respectively).  Each is broken into two lines here for rea-
  1010.      dability only.
  1011.  
  1012.      ?n?f%f .?m(file %i of %m) ..?e(END) ?x- Next\: %x.:
  1013.           ?pB%pB\%:byte %bB?s/%s...%t
  1014.  
  1015.      ?f%f .?n?m(file %i of %m) ..?ltline %lt?L/%L. :byte %bB?s/%s. .
  1016.           ?e(END) ?x- Next\: %x.:?pB%pB\%..%t
  1017.  
  1018.      And here is the default message produced by the = command:
  1019.  
  1020.      ?f%f .?m(file %i of %m) .?ltline %lt?L/%L. .
  1021.           byte %bB?s/%s. ?e(END) :?pB%pB\%..%t
  1022.  
  1023.      The prompt expansion features are also used for another pur-
  1024.      pose: if an environment variable LESSEDIT is defined, it is
  1025.      used as the command to be executed when the v command is
  1026.      invoked.  The LESSEDIT string is expanded in the same way as
  1027.      the prompt strings.  The default value for LESSEDIT is:
  1028.  
  1029.           %E ?lm+%lm. %f
  1030.  
  1031.      Note that this expands to the editor name, followed by a +
  1032.      and the line number, followed by the file name.  If your
  1033.      editor does not accept the "+linenumber" syntax, or has
  1034.      other differences in invocation syntax, the LESSEDIT vari-
  1035.      able can be changed to modify this default.
  1036.  
  1037.  
  1038. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  1039.      COLUMNS
  1040.           Sets the number of columns on the screen.  Takes pre-
  1041.           cedence over the number of columns specified by the
  1042.           TERM variable.
  1043.  
  1044.      EDITOR
  1045.           The name of the editor (used for the v command).
  1046.  
  1047.      HOME Name of the user's home directory (used to find a .less
  1048.           file).
  1049.  
  1050.  
  1051.  
  1052.  
  1053. Sprite v1.0                                                    16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. LESS                      User Commands                      LESS
  1061.  
  1062.  
  1063.  
  1064.      LESS Flags which are passed to _l_e_s_s automatically.
  1065.  
  1066.      LESSBINFMT
  1067.           Format for displaying non-printable, non-control char-
  1068.           acters.
  1069.  
  1070.      LESSCHARDEF
  1071.           Defines a character set.
  1072.  
  1073.      LESSCHARSET
  1074.           Selects a predefined character set.
  1075.  
  1076.      LESSEDIT
  1077.           Editor prototype string (used for the v command).  See
  1078.           discussion under PROMPTS.
  1079.  
  1080.      LESSHELP
  1081.           Name of the help file.
  1082.  
  1083.      LINES
  1084.           Sets the number of lines on the screen.  Takes pre-
  1085.           cedence over the number of lines specified by the TERM
  1086.           variable.
  1087.  
  1088.      SHELL
  1089.           The shell used to execute the ! command, as well as to
  1090.           expand filenames.
  1091.  
  1092.      TERM The type of terminal on which _l_e_s_s is being run.
  1093.  
  1094.  
  1095. SSEEEE AALLSSOO
  1096.      lesskey(1)
  1097.  
  1098.  
  1099. WWAARRNNIINNGGSS
  1100.      The = command and prompts (unless changed by -P) report the
  1101.      line number of the line at the top of the screen, but the
  1102.      byte and percent of the line at the bottom of the screen.
  1103.  
  1104.      If the :e command is used to name more than one file, and
  1105.      one of the named files has been viewed previously, the new
  1106.      files may be entered into the list in an unexpected order.
  1107.  
  1108.      The handling of national character sets is nonstandard as
  1109.      well as insufficient for multibyte characters.  It will
  1110.      probably change in a later release.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119. Sprite v1.0                                                    17
  1120.  
  1121.  
  1122.  
  1123.